flD-R124  210 


UNCLASSIFIED 


EDITSPEC:  SVSTEH  HRNUAL  VOLUME  VI  PROJECT  MANAGER 
PROCEDURES(U)  CONSTRUCTION  ENGINEERING  RESEARCH  LAB 
(RRNV)  CHAMPAIGN  IL  E  S  NEELV  RPR  80  DOD/DF-83/’B02H 


»A 124210 


EDITSPEC  SYSTEM  MANUAL 
Volune  6:  Project  Manager  Procedures 


E.  S.  Neely 


April  1980 


Tic 


O# 


Department  of  the  Atw 
CONSTRUCTION  ENGINEERING  RESEARCH  LABORATORY 
P.  0.  Box  4005 
Champaign,  IL  61820 


fJfflONAL  TECHNICAL 
INFORMATION  SERVICE 


Th’j  drxnunent  has  been  approved 
f;ir  public  relecse  cuid  soJe;  its 
fhbuticn  is  unlimitod. 


88  02  08  142 


ABSTRACT 


C; 

This  manual  provides  the  EDITSPEC  system  project  manager  with  the  loca¬ 
tion  of  the  detailed  Instructions  for  managing  the  EDITSPEC  system.  It 
also  provides  the  Computer  Services  Vendor  will  all  procedures  that 
require  modification. 
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Chapter  1:  Computer  Control 


The  procedures  to  control  computer  processing  are  presented  In 
three  sections: 

1.  Moving  From  a  Computer  System. 

2.  Moving  to  a  Computer  System. 

3.  Normal  Operating  Procedures. 


Moving  From  A  Computer  Ss 


The  procedures  required  to  move  all  EDITSPEC  related  Information 
from  the  computer  storage  to  tape  storage  are  presented  In  the  order  of 
normal  execution.  The  listing  of  all  procedures  Is  given  In  Appendix  A. 


Job  Control  Prooodure  Tapo  Production 


All  job  control  procedures  should  be  provided  to  the  prospective 
bidders  In  machine  readable  format.  The  job  control  to  produce  this 
tape  Is  given  In  Appendix  A.I. 

Souroe  Code  Tape  Produation 


There  are  two  basic  types  of  source  code  (1)  government  written 
code,  and  (2)  computer  services  contractor  written  code.  The  contractor 
mqy  have  modified  government  written  code;  therefore,  the  contractors 
routines  must  be  used  In  lieu  of  the  government  routines. 
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L  The  Job  control  to  produce  the  source  tapes  Is  given  In  Appendix 

A.2. 

System  Integration  Teat  (SIT) 

Each  conmand  in  the  system  must  be  fully  tested  to  insure  that  the 
command  works  property.  This  test  should  be  done  immediately  before  bid 
advertizing.  A  copy  of  the  input  and  the  correct  output  must  be  pro¬ 
vided  to  each  prospective  computer  service  vendor.  The  input  is  stored 
in  the  computer  in  datasets  that  have  the  following  naming  convention: 

.SITANAME. IN.DATA(&COMMAND) 

The  output  is  stored  in  dataset  that  have  the  following  naming  conven¬ 
tion: 

C  .SIT&NAME.OUT.DATA(&COMNAND) 

where 

ANAME  is  replaced  by: 

(1)  SY  for  system  commands 

(2)  ED  for  edit  commands 

(3)  IN  for  internal  commands 
ACOWAND  is  replaced  by  the  minimum 

allowable  characters  of  the  command  name. 

Therefore,  three  input  datasets  and  three  output  datasets  are  stored  in 
the  computer. 

The  input  data  should  be  defined  as  unit  5.  There  are  five  output 
datasets: 
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(1)  Unit  6  contains  the  basic  messages  to  the  user. 

(2)  Unit  7  Is  dunnyed.  The  unit  was  used  to  write  to  a  1200  cps 

printer  terminal. 

(3)  Unit  8  contains  printed  output  to  the  users  terminal. 

(4)  Unit  9  Is  dunmyed.  The  unit  was  used  to  write  to  a  central 

site  printer. 

(5)  Unit  10  contains  any  program  dumps  due  to  datahandler  errors. 

The  SIT  runs  use  seven  temporary  database  datasets: 

AISYSTEM 

BISYSTEM 

AISIT 

BISIT 

AIDCMNTS 

AlbCMNTS 

AINONITR 

The  catalogued  procedure  (EDITSPEC)  shown  In  Appendix  A.3  Is 
applied  to  execute  each  Individual  SIT  run  In  a  batch  environment.  The 
Job  control  to  execute  the  catalogued  procedure  Is  shown  In  Appendix 

« 

A.4.  The  ANAME  and  &C0MMAND  values  are  specified  as  shown  on  line 
nunbers  40  and  50.  The  Input  data  Is  placed  between  line  number  60  and 
80  as  shown. 


The  SIT  dataset  should  be  deleted  and  recreated  as  shown  In  Appen¬ 
dix  A.5.  A  master  computer  tape  of  the  input  and  output  datasets  should 
be  generated  as  shown  in  Appendix  A.7.  The  master  tape  can  be  dupli¬ 
cated  and  provided  to  the  prospective  bidders. 

Benehmark  Teat  (BffT) 


The  benchmark  test  runs  are  used  to  compare  computer  resources  and 
costs.  The  6MT  runs  should  be  performed  imnediately  before  bid  adver¬ 
tizing.  A  copy  of  the  input  and  the  correct  output  should  be  provided 
to  each  prospective  computer  service  vendor.  The  input  is  stored  in  the 
computer  in  datasets  that  have  the  following  naming  convention: 

^  .BMT&NAME.IN.DATA 

The  output  is  stored  in  datasets  that  have  the  following  naming  conven¬ 
tion: 

.BMT&NAME.OUT.DATA 


where 

AWAME  is  replaced  by: 

INIT  for  system  initialization 
DITIO  for  BMTI 
Dll  through  055  for  BMT2 
PROJ  for  BMT3 


C 


Therefore*  forty>e1ght  Input  datasets  and  forty-eight  out^t  datasets 
are  stored  In  the  computer. 

The  required  Input  and  output  datasets  are  the  same  as  defined  In 
the  SIT  description.  The  6MT  runs  apply  the  following  temporary  data¬ 
base  datasets  for  the  BNT  Initialization  run: 


AlTESTl 

BlTESn 

A1TEST2 

B1TEST2 

A1TEST3 

B1TEST3 

A1TEST4 

B1TEST4 

A1TEST5 

B1TEST5 

The  BNT  runs  apply  the  following  permanent  database  datasets: 

Permanently  Coded 

AISYSTEM 

BISYSTEM 

AlHONITOR 

Dynamically  Allocated 

A1  &  B1  datasets  for  TESTll  through  TESTS5 

AITEST 

BITEST 

The  catalogued  procedure  (EDSPBNT)  shown  In  Appendix  A.8  Is  applied 
to  execute  each  Individual  6MT  run  In  a  batch  environment.  The  job 
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control  to  execute  the  catalogued  procedure  Is  shown  In  Appendix  A.9. 

The  &NAME  value  is  specified  as  shown  on  line  number  40.  The  input  data 
is  placed  between  line  number  60  and  80  as  shown. 

The  SIT  datasets  should  be  deleted,  recreated,  and  initialized  as 
shown  in  Appendix  A.IO. 

A  master  computer  tape  of  the  input  and  output  datasets  should  be 
generated  as  shown  in  Appendix  A.12.  The  master  tape  can  be  duplicated 
and  provided  to  prospective  bidders. 

Dababaae  Canuereion 

The  procedures  to  convert  and  restore  the  database  are  given  in  the 
0/M  manual.  The  job  control  is  shown  in  Appendix  A.13  Unit  10  is 
applied  as  the  conversion  tape  unit. 


to  a  System 


The  procedures  required  to  load  EDITSPEC  related  information  from 
tape  storage  to  computer  storage  area  operating  system  dependent  and 
cannot  be  explicity  defined  in  this  section.  The  general  description 
follows  the  section  on  moving  from  a  computer  system.  The  order  should 
be  as  follows: 


1.  Load  Job  Control  Procedure  Tape 


2.  Load  Source  Code  Tape 
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Load  SIT  Tape 


4*  Load  BMT  Tape 

Production  Procedures 


normal 

EDITSPEC  operates  in  both  interactive  and  batch  prcessing  inodes. 

The  normal  interactive  procedure  is  shown  in  Appendix  B.l.  A  master 
training  database  has  been  established  and  the  interactive  procedure 
given  In  Appendix  B.2.  The  normal  training  course  procedure  is  shown  in 
Appendix  B.3.  Before  a  training  course  is  given,  the  master  trianing 
database  must  be  copied  over  the  normal  trainign  database.  This  pro¬ 
cedure  is  shown  in  Appendix  B.4. 

The  normal  batch  procedure  for  the  SUBMIT  command  is  shown  in 
Appendix  B.5.  The  batch  procedure  from  cards  Is  given  in  Appendix  B.6. 

Mainterumoe 

Both  programs  and  databses  must  be  maintained.  The  source  programs 
and  the  CE6S  guide  database  can  be  backed  up  on  the  15th  and  the  last 
d^y  of  each  month  as  shown  in  Appendix  B.7.  Normal  document  dataset  can 
be  backed  up  preiodically  as  shown  in  Appendix  B.8.  this  procedure  must 
be  conducted  in  sequence  with  the  normal  EDITSPEC  backup  system. 


Dataset  restoration  is  shown  In  Appendix  B.9.  This  procedure  must 
be  conducted  In  sequence  with  the  normal  EDITSPEC  restoration  procedure 
shown  In  the  Appendix  B.9. 

Program  Modification 

Programs  can  be  modified  In  both  batch  and/or  Interactive  process¬ 
ing  modes.  The  activities  are  basically  the  same  for  each  mode. 

The  first  activity  Is  to  create  a  test  source  subroutine.  This  can 
be  performed  by  copying  an  existing  subroutine  as  shown  In  Appendix  B.IO 
or  by  writing  a  new  program  on  computer  cards. 

The  test  subroutine  can  be  compiled  and  tested  as  shown  In  Appendix 

B.ll. 


When  the  subroutine  Is  completely  debugged.  It  can  be  added  to  the 
source  library  as  shown  In  Appendix  B.12. 

The  source  can  be  compiled  Into  the  EDITSPEC  system  as  shown  In 
Appendix  B.13.  The  above  step  can  be  combined  as  shown  In  Appendix 
6.12. 


The  source  datasets  require  a  compression  to  remove  old  programs. 
The  procedure  Is  given  In  Appendix  B.14.  The  compression  can  be  com¬ 
bined  with  the  above  two  steps  as  shown  in  Appendix  B.12. 

Once  the  complete  test  version  of  the  EDITSPEC  system  has  been  com¬ 


pletely  tested.  It  can  be  released  for  production.  All  batch  and 


Interactive  users  must  be  off  of  the  computer  system  before  the  pro¬ 
cedure  in  Appendix  6.15  can  be  Issued. 
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Chapter  2:  Resource  Control 


Personnel  Management 

The  project  manager  Is  the  controller  of  aVi  personnel  within  the 
system.  The  project  manager's  user  ID  Is  the  only  user  ID  that  will  be 
permitted  to  list  passwords  for  other  users.  Conversion  from  one  com¬ 
puter  system  to  another  Is  allowed  to  be  performed  only  by  the  project 
manager. 

The' user  ID  for  the  supervisor  for  each  office  must  be  assigned  by 


( 


the  project  manager 


Chapter  3:  Operations  and  Maintenance 

It  Is  the  responsibility  of  the  project  manager  to  establish  all 
schedules  for  operating  and  maintaining  the  EDITSPEC  system.  The 
detailed  procedures  are  given  In  Volume  7. 


Chapter  4:  System  Enhancement 


The  project  manager  has  two  methods  for  enhancing  the  EDITSPEC  sys 
tern.  Large  and  complicated  additions  can  be  performed  through  periodic 
contracts  to  software  developers.  The  original  system  developer  could 
be  employed  to  m1n1ml2e  the  cost  for  the  learning  of  the  existing  sys> 
tern.  Small  and  minor  enhancements  may  be  performed  by  the  maintalners 
themselves  If  resources  are  available.  Procedures  for  enhancement  are 
given  In  Voliine  5.  "Conversion  and  Extension." 


Chapter  6:  Adding  A  New  Office 


Providing  Information  to  a  Prospective  Office 

The  report  entitled  "Construction  Specification  Preparation  Within 
the  EDITSPEC  System"  provides  management  personnel  with  a  brief  descrip¬ 
tion  of  the  computer  system.  Chapter  5  of  this  report  presents  a  sys¬ 
tematic  method  for  the  evaluation  and  possible  application  of  the 
EDITSPEC  system.  The  program  manager  should  have  a  working  knowledge  of 
this  chapter.  The  following  Items  might  prove  beneficial  to  be  provided 
In  an  Information  package: 

(1)  The  above-mentioned  report. 

(2)  A  list  of  contact  persons  within  offices  that  are  currently 
using  EDITSPEC.  The  persons  listed  should  have  agreed  to  having  their 
names  on  the  list  and  be  willing  to  share  their  experiences  with  others. 

(3)  A  list  of  current  training  courses,  locations,  and  dates. 

(4)  Users  manual. 

(5)  Standard  guide  specification  format  definitions. 

A  person  from  the  "HOT  LINE"  staff  should  be  assigned  to  work  with 
the  new  office  In  the  evaluation  process.  This  person  can  show  where 
EDITSPEC  can  save  resources  within  the  new  office. 


Obtaining  a  Computer  Account  Nwnber 


The  person  from  the  project  manager's  staff  working  with  the  new 
office  should  provide  the  office  supervisor  with  the  required  Informa¬ 
tion  to  open  a  new  computer  service  account. 

Preparing  for  the  Use  of  EDltlPEC 
Hew  Office 

The  Internal  EOITSPEC  resources  must  be  established  and  standard 
operating  procedures  adopted.  User  and  supervisor  IDs  must  be  esta¬ 
blished.  Project  and  document  naming  conventions  adopted.  Account 
numbers  assigned. 

The  most  important  part  is  the  definition  of  the  standard  Internal 
coding  formats  and  standard  print  formats. 

Profeet  Mccnager 

The  project  manager's  staff  must  prepare  the  required  catalog  pro¬ 
cedures  for  each  office  and/or  user  within  the  office. 

Adding  the  Office  Supervisor 

The  ".SUPER."  command  should  be  used  to  enter  the  supervisor  of  the 
new  office.  This  supervisor  will  enter  all  other  users  under  his  con- 


Chapter  7:  Removing  An  Existing  Office 


Saving  Existing  Documents 

The  office  to  be  removed  may  have  many  documents  stored  within  the 
system.  Some  docunents  may  be  very  valuable  to  other  offices  even  after 
this  office  is  removed.  All  valuable  documents  should  have  their  crea¬ 
tors  changed  to  a  person  within  the  supervising  office.  All  other  docu¬ 
ments  should  be  deleted  from  the  computer. 

Deleting  Users  and  Supervisors 

All  Information  controlled  by  this  office  can  be  deleted  by  simply 
deleting  the  first-line  supervisor  for  the  office. 

Computer  Access 

All  access  to  computer  accounts  and  all  cataloged  procedures  should 


be  removed  from  the  system 
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